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REPRESENTING A SERVICE DISCOVERY 
STREAM AS AN N-ARY TREE 



5 RELATED APPLICATIONS 

This application is a continuation in part of U.S. Patent Application No. 
09/557,947 filed April 24, 2000. 

10 TECHNICAL FIELD 

This invention relates generally to communication between electronic devices and, 

more particularly, relates to methods to discover services provided by server applications. 
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BACKGROUND OF THE INVENTION 



«: J There are a significant number of wireless technologies in the marketplace today. 

! .3 The emerging standard for short range wireless technology is called Bluetooth. Bluetooth 

fU 

;;0 is a Radio Frequency (RF) specification for short-range, point-to-multipoint voice and 

data transfer. Bluetooth can transmit through solid, non-metal objects and its nominal 
! 2 0 link range is from 10 cm to 10 m, but can be extended to 100 m by increasing the 

transmit power. It is based on a low-cost, short-range radio link, and facilitates ad hoc 
connections for stationary and mobile communication environments. The Bluetooth 
wireless technology allows users to make connections between communication devices 
such as mobile phones and desktop and notebook computers. Finding and making use of 
2 5 services in these environments is becoming increasingly important due to the continued 
growth in wireless technologies as seen by the proliferation of mobile computing devices 
and also to the merging of wireless technologies and computer technologies. These 



services can include basic services such as printing, faxing, paging, etc., more complex 
services such as video conferencing and teleconferencing, and any other type of service 
that a service provider may provide. Bluetooth utilizes a Service Discovery Protocol to 
allow communication devices to find and make use of these services. 

A service discovery stream consists of a linear stream of data that has data 
structures encoded within it to represent an available service on an enabled device. There 
are eight types of data encoded within a service discovery stream. These types are nil 
(null type), unsigned integer, signed twos-complement integer, universally unique 
identifier (UUID), text string, Boolean, data element sequence, data element alternative, 
and uniform resource locater (URL). A data element sequence is a data element whose 
data field is a sequence of data elements. A data element alternative is a data element 
whose data field is a sequence of data elements from which one data element is to be 
selected. 

Each element in the service discovery stream has a size attribute which describes 
the byte size of its content. A sequence or alternative element may have children 
elements within it. Since the terminating elements are embedded in the outer elements, 
the service discovery stream must be constructed from the bottom up. 

There are several issues that arise with service discovery streams. Creating a well 
formed service discovery stream is not straightforward. Traversing a service discovery 
stream in a simple manner is not easy because a large amount of descriptive data must be 
maintained due to the embedded data structures contained in the service discovery 
stream. These embedded data structures may also have structures embedded in them ad 
infinitum. Additionally, modifying a service discovery stream can be complex and 



introduce errors. The modification, whether it be adding, changing, or removing a data 
structure, may alter bytes before, after, and at the point of modification, thereby 
increasing the likelihood of error. What is needed is a way to represent a service 
discovery stream that reduces the complexity of traversing the stream and that makes 
modifications to the stream easier to implement. 

SUMMARY OF THE INVENTION 

In view of the above problems, the service discovery stream is represented as an 
N-ary tree. By representing the service discovery stream as an N-ary tree, each element 
does not need to know the size of all of its children elements until the N-ary tree is 
converted into a service discovery stream. This allows for the quick construction of a 
well formed service discovery stream. The process is centered on grouping the data 
together and not how the data is actually represented in the service discovery stream. 
Traversing an N-ary tree is also a much simpler task. Very little information needs to be 
maintained during the traversal. Modifying a node in an N-ary tree is a trivial task. Since 
the tree is a non linear structure, any of the three types of modifications (changing, 
adding, or removing) requires only one modification to the entire tree. 

The content of the service discovery stream is traversed linearly to ensure it is 
well formed and the number of data elements contained in the service discovery stream is , 
counted. The number of nodes in the N-ary tree is determined based upon the number of 
data elements. A list head is initialized. An element from the service discovery stream is 
obtained and a node is initialized with the element and information about the element. If 
the node is a leaf node, the node is added to the list head and the next element from the 



service discovery stream is obtained. If the node is a parent node, the node is added to 
the list and the element is checked to see if there are any children. If there are children, 
the children are listed in the list head of the parent node. The next element is obtained 
from the service discovery stream and a node is initialized with the next element. The 
process is repeated until all elements in the service discovery stream have been converted. 

Additional features and advantages of the invention will be made apparent from 
the following detailed description of illustrative embodiments which proceeds with 
reference to the accompanying figures. 

BRIEF DESCRIPTION OF THE DRAWINGS 

While the appended claims set forth the features of the present invention with 
particularity, the invention, together with its objects and advantages, may be best 
understood from the following detailed description taken in conjunction with the 
accompanying drawings of which: 

Figure 1 is a block diagram generally illustrating an exemplary computer system 
on which the present invention resides; 

Figure 2 is a flowchart illustrating how a service discovery stream is converted 
into an N-ary tree using a sentinel head; 

Figure 3 is a flowchart illustrating how a service discovery stream is converted 
using a node; 

Figure 4 is a flowchart illustrating how a service discovery stream is recursively 
converted into an N-ary tree; and 

Figure 5 shows an illustrative example of an N-ary tree. 
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DETAILED DESCRIPTION OF THE INVENTION 

Turning to the drawings, wherein like reference numerals refer to like elements, 
the invention is illustrated as being implemented in a suitable computing environment. 
5 Although not required, the invention will be described in the general context of computer- 
executable instructions, such as program modules, being executed by a personal 
computer. Generally, program modules include routines, programs, objects, components, 
data structures, etc. that perform particular tasks or implement particular abstract data 
i'S types. Moreover, those skilled in the art will appreciate that the invention may be 

: -f% 

i .S ; ! 

lift 1 1 0 practiced with other computer system configurations, including hand-held devices, multi- 

. 

:: P processor systems, microprocessor based or programmable consumer electronics, 

i ; t 3 
Mi 

network PCs, minicomputers, mainframe computers, and the like. The invention may 
]% also be practiced in distributed computing environments where tasks are performed by 

in remote processing devices that are linked through a communications network. In a 

, 

i!3 15 distributed computing environment, program modules may be located in both local and 
remote memory storage devices. 

With reference to Fig. 1 , an exemplary system for implementing the invention 
1 includes a general purpose computing device in the form of a conventional personal 
' computer 20, including a processing unit 2 1 , a system memory 22, and a system bus 23 
20 that couples various system components including the system memory to the processing 
unit 2 1 . The system bus 23 may be any of several types of bus structures including a 
memory bus or memory controller, a peripheral bus, and a local bus using any of a variety 
of bus architectures. The system memory includes read only memory (ROM) 24 and 
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random access memory (RAM) 25. A basic input/output system (BIOS) 26, containing 
the basic routines that help to transfer information between elements within the personal 
computer 20, such as during start-up, is stored in ROM 24. The personal computer 20 
further includes a hard disk drive 27 for reading from and writing to a hard disk, not 
5 shown, a magnetic disk drive 28 for reading from or writing to a removable magnetic disk 
29, and an optical disk drive 30 for reading from or writing to a removable optical disk 3 1 
such as a CD ROM or other optical media. 

The hard disk drive 27, magnetic disk drive 28, and optical disk drive 30 are 

t 
i 

! connected to the system bus 23 by a hard disk drive interface 32, a magnetic disk drive 

1 0 interface 33, and an optical disk drive interface 34, respectively. The drives and their 
associated computer-readable media provide nonvolatile storage of computer readable 
! instructions, data structures, program modules and other data for the personal computer 
20. Although the exemplary environment described herein employs a hard disk, a 
removable magnetic disk 29, and a removable optical disk 31, it will be appreciated by 

1 5 those skilled in the art that other types of computer readable media which can store data 
that is accessible by a computer, such as magnetic cassettes, flash memory cards, digital 
video disks, Bernoulli cartridges, random access memories, read only memories, and the 
like may also be used in the exemplary operating environment. 

A number of program modules may be stored on the hard disk, magnetic disk 29, 

2 0 optical disk 31, ROM 24 or RAM 25, including an operating system 35, one or more 
applications programs 36, other program modules 37, and program data 38. A user may 
enter commands and information into the personal computer 20 through input devices 
such as a keyboard 40 and a pointing device 42. Other input devices (not shown) may 
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include a microphone, joystick, game pad, satellite dish, scanner, or the like. These and 
other input devices are often connected to the processing unit 21 through a serial port 
interface 46 that is coupled to the system bus, but may be connected by other interfaces, 
such as a parallel port, game port or a universal serial bus (USB). A monitor 47 or other 
5 type of display device is also connected to the system bus 23 via an interface, such as a 
video adapter 48. In addition to the monitor, personal computers typically include other 
peripheral output devices, not shown, such as speakers and printers. 

The personal computer 20 may operate in a networked environment using logical 
v3 connections to one or more remote computers, such as a remote computer 49. The 

j ;n i o remote computer 49 may be another personal computer, a server, a router, a network PC, 

a peer device or other common network node, and typically includes many or all of the 
'y elements described above relative to the personal computer 20, although only a memory 

; 5 storage device 50 has been illustrated in Fig. 1. The logical connections depicted in Fig. 

LI] 1 include a local area network (LAN) 5 1 and a wide area network (WAN) 52. Such 

□ 1 5 networking environments are commonplace in offices, enterprise-wide computer 
networks, intranets and the Internet. 

When used in a LAN networking environment, the personal computer 20 is 
connected to the local network 51 through a network interface or adapter 53. When used 
in a WAN networking environment, the person computer 20 typically includes a modem 
20 54 or other means for establishing communications over the WAN 52. The modem 54, 
which may be internal or external, is connected to the system bus 23 via the serial port 
interface 46. In a networked environment, program modules depicted relative to the 
personal computer 20, or portions thereof, may be stored in the remote memory storage 
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device. It will be appreciated that the network connections shown are exemplary and 
other means of establishing a communications link between the computers may be used. 

In the description that follows, the invention will be described with reference to 
acts and symbolic representations of operations that are performed by one or more 
5 computer, unless indicated otherwise. As such, it will be understood that such acts and 
operations, which are at times referred to as being computer-executed, include the 
manipulation by the processing unit of the computer of electrical signals representing data 
in a structured form. This manipulation transforms the data or maintains it at locations in 
the memory system of the computer, which reconfigures or otherwise alters the operation 
m 10 of the computer in a manner well understood by those skilled in the art. The data 
:-.C structures where data is maintained are physical locations of the memory that have 

P particular properties defined by the format of the data. However, while the invention is 

i i 

i: ; 8 being described in the foregoing context, it is not meant to be limiting as those of skill in 

; % the art will appreciate that various of the acts and operation described hereinafter may 

|=3 1 5 also be implemented in hardware. 

When converting a service discovery stream into an N-ary tree, each data type is 
classified as either a leaf node or a parent node. A leaf node is defined as a node which 
can contain no children and a parent node is defined as a node that can potentially have 
children. The types of data that are leaf node types are Nil, Unsigned integer, Signed 
2 0 integer, UUID (universally unique identifier), Text string, Boolean, and URL (uniform 
resource locator). The types of data that are parent node types are Data element sequence 
and Data element alternative. By definition, each node in the tree, including the root 
node, can have N siblings, where N is any number. The siblings are connected to each 



other using a doubly linked list. A doubly linked list is a series of nodes in which each 
node refers to both the next node and the preceding node, thereby forming two-way 
references. A doubly linked list can be traversed both forward and backward. 
Conversely, a singly linked list can only be traversed forward. 

Once a service discovery stream has been acquired, two steps are performed 
before it is converted into an N-ary tree. In the first step, the content of the service 
discovery stream is validated by traversing the stream linearly to make sure it is well 
formed. If the service discovery stream is not well formed, an error is returned and the 
service discovery stream is not converted into an N-ary tree. In the second step, the 
number of elements contained in the service discovery stream is counted. 

Turning now to figure 2, the steps taken to convert a service discovery stream will 
be described when the service discovery stream has a sentinel node. A sentinel node is a 
node that contains no data and its purpose is to demarcate the terminal node. In the 
description that follows, the term "container" refers to either an alternative element or a 
sequence element. An array of SD_NODEs is created (step 100). The number of nodes 
in the array is set to the number of required nodes plus one. The number of required 
nodes is based upon the number of elements in the stream. A node is defined as: 

Struct SD_NODE_HEADER{ 

UCHAR Type; // contains the element type 

UCHAR SpecificType; // contains specific element type (i.e, a 4 

byte integer) 

LIST_HEAD Link; 

} 

struct SD_NODE { 

SD_NODE_HEADER hdr; 
union { 

// all of the different data types defined 
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// . . . etc. . . 
// sequence 

SDNODEHEADER sequenceHdr; 
// alternative 

SD_NODE_HEADER alternativeHdr; 

}u; 

} 

where sequenceHdr and alternativeHdr are list heads. A list head in its simplest form is 
the beginning of the list. An SDNODE from the stream is acquired and initialized as the 
list head (step 102). A stack is created (step 104) and the list head is set to the first 
SDNODE's sibling list pointer (step 106). The data type and data size is retrieved from 
the stream (step 1 08) and the current node is initialized with the data type, the data size, 
and the stream data (step 1 10). The current node is checked to see if it is a leaf node or a 
parent node (step 1 12). 

If the current node is a parent node, the size of the node's content is determined 
and checked to see if it is equal to zero (step 122). If the content is non-zero, the service 
discovery stream is incremented to the beginning of the next element of the service 
discovery stream (step 124). The current list head, current node, and service discovery 
stream size is pushed into the stack (step 126) and the current node is added to the tail of 
the list head (step 128). The list head is set to the current node's container list head (step 
130) and the service discovery stream size is set to the size of the container's stream size 
(step 132). The next node is obtained from the list (step 134) and steps 108-1 12 are 
repeated for the service discovery stream. If the content is zero, the stream size is 
checked to determine if it is zero (step 136). 



If the current node is a leaf node, the current node is added to the tail of the tail of 
the list head (step 1 14) and the service discovery stream is adjusted beyond the data 
element (step 116). The stream size is decremented by the size of the element (step 118) 
and the next node is obtained from the list (step 120). The stream size is then checked to 
determine if it is zero (step 136). 

If the stream size is not zero, the process for the next node is started by repeating 
steps 108 to 136. If the stream size is zero, the stack is checked to see if it is empty (step 
138). If the stack is empty, the conversion is completed (step 140). If the stack is not 
empty, a list head, node, and stream size is popped from the stack (step 142) and the 
popped node's children pointer is set to the current list head (step 144). The stream size is 
set to the popped stream size minus the popped node's size (step 146) and the list head is 
set to the popped list head (step 148). The stream size is checked to determine if it is zero 
(step 136) and the process of steps 108-148 is repeated until the stack is empty. 

Turning now to figure 3, the steps taken to convert a service discovery stream will 
be described when the service discovery does not have a sentinel node. Note that these 
steps can also be used if the service discovery stream has a sentinel node. A stack is 
created (step 200) and an array of SD_NODEs is created (step 202). The number of nodes 
is based upon the number of elements in the stream The node is defined as: 



struct SD_NODE { 

UCHAR Type; 
UCHAR SpecificType; 



// contains the element type 
// contains specific element type (i.e, a 4 
byte integer) 



ULONG DataSize; // size of the element's data 



union { 



// all of the different data types defined 



}u; 
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LISTENTRY Link; // link to next and previous siblings 

} 

The current service discovery stream size is stored (step 204) and the list head is 
5 set to the service discovery stream's first SD_NODE's sibling list pointer (step 206). The 
data type and data size is retrieved from the service discovery stream (step 208) and the 
current node is initialized with the data type, the data size, and the service discovery 
stream data (step 210). The current node is checked to see if it is a leaf node or a parent 
node (step 212). 

I K 10 If the current node is a parent node, the size of the node's content is determined 

m . 

i;o and checked to see if it is equal to zero (step 222). If the content is non-zero, the service 

■P ' discovery stream is incremented to the beginning of the next element of the service 

discovery stream (step 224). The current node is added to the list head (step 226), and the 

t : 

^ current list head, node, and stream' size is pushed into the stack (step 228). The next node 

; S 15 from the service discovery stream is obtained (step 230) and the list head is set to the next 
i;3 node's sibling list pointer (step 232). The stream size is set to the size of the parent node 

; i content size (step 234) and steps 208-212 are repeated for the next node. If the content is 
1 zero, the stream size is checked to determine if it is zero (step 236). 

If the current node is a leaf node, the current node is added to the list head (step 
20 214) and the service discovery stream is adjusted beyond the data element (step 216). 

The stream size is decremented by the size of the element (step 218) and the next node is 
obtained (step 220). The stream size is then checked to determine if it is zero (step 236). 

If the stream size is not zero, the process for the next node is started by repeating 
steps 208 to 236. If the stream size is zero, the stack is checked to see if it is empty (step 



238). If the stack is empty, the conversion is completed (step 240). If the stack is not 
empty, a list head, node, and stream size is popped from the stack (step 242) and the 
popped node's children pointer is set to the current list head (step 244). The stream size is 
set to the popped stream size minus the popped node's size (step 246) and the list head is 
set to the popped list head (step 248). The stream size is checked to determine if it is zero 
(step 236) and the process of steps 208-248 are repeated until the stack is empty. 

Turning now to Figure 4, the steps taken to convert a service discovery stream to 
an N-ary tree will be described using a recursive method. These steps can be used for any 
valid service discovery stream. An array of SD_NODEs is created (step 300). The 
number of nodes in the array is set to one more than the number of required nodes. The 
number of required nodes is based upon the number of elements in the stream. A node is 
defined as: 

Struct SD_NODE_HEADER{ 

UCHAR Type; // contains the element type 

UCHAR SpecificType; // contains specific element type (i.e, a 4 

byte integer) 

LIST J1EAD Link; 

} 

struct SD_NODE { 

SD_NODE_HEADER hdr; 
union { 

// all of the different data types defined 
// . . . etc. . . 
// sequence 

SD_NODE_HEADER sequenceHdr; 
// alternative 

SD_NODE_HEADER alternativeHdr; 

}u; 

} 



where sequenceHdr and alternativeHdr are list heads. The list head is set to the first 
SD_NODE , s sibling list pointer (step 302) and the next node is obtained (step 304). A 
parsing function is called passing a reference to the list head, the node list, the service 
discovery stream, and the stream size (step 306). The stream size is checked to determine 
if it is zero (step 308). If the stream size is zero, the process ends (step 3 1 0). 

If the stream size is not zero, the data type and data size is retrieved from the 
service discovery stream (step 312) and the current SDNODE is initialized with the data 
type, data size, and the stream data (step 314). The current node is checked to see if it is a 
leaf node or a parent node (step 316). 

If the current node is a parent node, the service discovery stream is incremented to 
the beginning of the next element of the service discovery stream (step 326). The current 
node is added to the list head (step 328) and the stream size is set to the size of the 
container's stream size (step 330). The next node is obtained from the list (step 332) and 
steps 308-3 16 are repeated for the next node. 

If the current node is a leaf node, the current node is added to the list head (step 
3 1 8) and the service discovery stream is adjusted to beyond the element (step 320). The 
stream size is decremented by the size of the element (step 322) and the next node is 
obtained from the list (step 324). The process outlined in steps 308 to 334 is then 
repeated until a stream size of zero is detected, at which time the process ends. 

Figure 5 illustrates an exemplary N-ary tree for a service discovery stream 
obtained from following the steps outlined in any of the embodiments described above. 
For purposes of illustration, the service discovery stream contains a sequence which 
contains an 8 bit unsigned integer of 4 and another sequence which contains two 8 bit 



unsigned integers of 10 and 20. The service discovery stream would look like 
0x350808043504080a0814 (hex). In Figure 5, a line with a single arrow indicates a 
single link between elements and a line with two arrows indicates a double link between 
elements. The first sequence 460 of the N-ary tree is linked to the unsigned integer of 4 
(UINT (4)) 462. The UINT 462 is doubly linked to sequence 464 which is linked to 
UINT(IO) 466, the unsigned integer of 10 and UINT(20) 468, the unsigned integer of 20. 
It should be noted that the data size is not required for the N-ary tree. 

An addition of a sequence to the N-ary tree or the addition of a data structure to a 
sequence of the N-ary tree would simply require the sequence or data structure to be 
added to be inserted into the tree at the appropriate location and linked to the adjacent 
data structure/sequence of the tree. Removing a data structure or sequence merely 
requires the data structure or sequence to be removed to be taken out of the tree and 
linking the data structures/sequences that were linked to the removed data structure or 
sequence to each other. Similarly, all that is needed to change a sequence or data 
structure is to combine the steps of adding and removing a sequence or data structure. 
Note that adding, removing, or changing a sequence or data structure only requires one 
modification to the tree. Conversely, modification of a service discovery stream may 
alter bytes before, after, and at the point of modification. 

Constructing a service discovery stream from an N-ary tree is straightforward. 
The service discovery stream must be constructed from the bottom up. Beginning at the 
bottom of the N-ary tree, the sequences and their elements are converted one sequence at 
a time. The conversion requires that the data element size and the data element type be 
included with the element in a linear stream of data. After the first sequence and its 
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elements have been converted, the next sequence is converted and placed in front of the 
linear stream of data representing the first sequence. The conversion is repeated until all 
sequences are converted, which results in the service discovery stream. 

Representing a service discovery stream as an N-ary tree has been described. The 
5 ease of which the N-ary tree can be modified has been described. This likelihood of error 
is reduced since only one modification to the tree is required when a change, addition, or 
removal of a data structure or sequence is made. The data size of a data structure does 
not need to be known until the tree is converted into a service discovery stream. 
All of the references cited herein, including patent applications are hereby 
;;H 10 incorporated in their entireties by reference. In view of the many possible embodiments 
„p to which the principles of this invention may be applied, it should be recognized that the 

=P embodiment described herein with respect to the drawing figures is meant to be 

;, J illustrative only and should not be taken as limiting the scope of invention. For example, 

; ~ those of skill in the art will recognize that the elements of the illustrated embodiment 

s'g 15 shown in software may be implemented in hardware and vice versa or that the illustrated 
embodiment can be modified in arrangement and detail without departing from the spirit 
of the invention. Therefore, the invention as described herein contemplates all such 
embodiments as may come within the scope of the following claims and equivalents 
thereof. 
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